这里是去除多余格式标识、仅保留纯 Markdown 文本的 ccusage 使用指南，可直接复制使用：

ccusage 使用指南：Claude 用量追踪工具

简介

ccusage 是一款轻量高效的命令行工具，核心用于：

  • 精确追踪 Claude Code 的 token 消耗、成本分布及使用趋势
  • 支持多平台运行（Node.js/Deno 环境均可，无需复杂配置）

安装方法

1. 免安装快速调用（推荐）

# bunx 调用（最快）
bunx ccusage

# npx 调用
npx ccusage@latest

# Deno 调用
deno run -E -R=$HOME/.claude/projects/ -S=homedir -N='raw.githubusercontent.com:443' npm:ccusage@latest

2. 全局安装（长期使用）

# npm
npm install -g ccusage

# bun
bun install -g ccusage

核心功能：Claude 用量管理

1. 基础用量查询

命令 功能描述
ccusage 或 ccusage daily 展示当日 token 消耗、成本估算、缓存命中情况
ccusage monthly 查看当月用量趋势与汇总数据
ccusage session 按对话拆分消耗，适合项目级成本核算
ccusage blocks 监控 Claude 5 小时账单周期的消耗速率
ccusage blocks --live 实时刷新当前账单区块的消耗与剩余预算

2. 高级筛选与导出

# 按日期范围查询（示例：2025年1月）
ccusage daily --since 20250101 --until 20250131

# 按模型拆分用量（Opus/Sonnet等）
ccusage monthly --breakdown

# 导出JSON格式数据（用于二次分析）
ccusage monthly --json > 2025_用量数据.json

进阶技巧

  1. 多设备同步 将 Claude 数据目录（默认 ~/.config/claude/projects/）同步至云盘（如 iCloud、OneDrive），即可实现跨设备的用量数据统一分析，无需重复配置。

  2. 工具集成 通过 JSON 输出格式，可对接第三方工具拓展使用场景：

    • 搭配 Raycast 快捷指令，一键查看当日用量
    • 集成 Neovim 插件，在开发时实时监控 token 消耗
    • 导入自定义 Web 仪表盘，可视化展示长期用量趋势

注意事项

  • 成本估算为模拟值：基于公开的 token 定价（如 Opus 模型 token 单价）计算，可能与 Claude 官方实际账单存在微小差异，仅供参考。
  • 自定义数据路径：若 Claude 数据目录非默认路径，可通过 --data-dir 参数指定，例如：
ccusage daily --data-dir /path/to/custom/claude/data

如需进一步了解工具更新或解决使用问题，可参考 官方仓库文档 或提交 issue 反馈。